---
title: 导入导出服务
---

## 导入流程

1. 上传文件到对象存储，获取 `fileID` 返回值。
2. 用 `fileID` 参数调用导入接口，同时设置导出类型 `outputType`（1 导入为 unit 文档，2 导入以得到 json 数据），获取 `taskID` 返回值。
3. 轮询获取转换结果，根据 `status` 返回值处理：
    - `pending`：需要接着轮询。
    - `done`：转换成功，得到 `import.jsonID` 或 `import.unitID` 返回值。
    - `failed`：转换失败，根据 `error.message` 获取错误信息。
4. 如果你想得到 json 数据而不是 unit 文档，请使用 `import.jsonID` 调获取文件接口下载转换结果。注意得到 json 数据后，还需要 [转换一下](/guides/docs/features/import-export#服务端数据转化) 才能使用到 Univer 中。

![import](./import-export/import.png)

## 导出流程

1. 用 `unitID` 参数调用导出接口，获取 `taskID` 返回值。
2. 轮询获取转换结果，根据 `status` 返回值处理：
    - `pending`：需要接着轮询。
    - `done`：转换成功，得到 `export.fileID` 返回值。
    - `failed`： 转换失败，根据 `error.message` 获取错误信息。
3. 使用 `export.fileID` 调获取文件接口下载转换结果。

![import](./import-export/export.png)

## API

查看 [Univer Server API 定义](/guides/pro/api)

导入案例：https://github.com/dream-num/usip-example/tree/main/import
